查詢運算式說明

查詢運算式說明

檔案約定

查詢運算式以斜體表示。

例: %rating% GREATER 3

查詢示例可能包括在半角尖括號中的占位符。它們需要在實際的查詢中置換為有實際意義的名稱。如果在示例中有多個同一類型占位符，在占位符後將會加上數位以示區別。

例: <field> GREATER <number>

本檔案包括的占位符類型的說明:

<field>
一條對欄位名(Tag Field)的引用。可以為純欄位名稱或標題格式化運算式(title formatting)。參考注意事項取得詳細訊息。
<number>
一個整數。
<string>
一條含在雙引號中的文字。參考注意事項取得詳細訊息。
<time>
一條時間資料或計算時間的標題格式化運算式。參考時間運算式取得詳細訊息。
<expression>
一條在組合查詢中的查詢運算式。規則遵循下面的進階查詢一節。

簡單查詢

簡單查詢模式不使用任何關鍵字.

<any string>
返回原資料或檔案路徑包括指定全部字句的項目。

進階查詢

進階查詢容許建立更復雜的查詢。它提供了一些關鍵字以對指定類型進行比較和組合多個查詢運算式。

文字運算式

<field> HAS <string>
返回在指定原資料欄位 <field> 中包括全部字句的項目。
例 : title HAS blah
<field> IS <string>
返回指定原資料欄位 <field> 中等於 <string> 的項目。
例: artist IS blah
* HAS <string>
與簡單查詢效果相同，但可以與邏輯運算符結合 (參考後文)。

數位運算式

在數值 <field> 和 <number> 之間執行整數比較Performs integral number comparison between the value of a <field> and a <number>, 例: ”%rating% GREATER 3”。

<field> GREATER <number>
大於。
<field> LESS <number>
小於。
<field> EQUAL <number>
等於。

原資料運算式

<field> MISSING
返回不存在指定原資料欄位 <field> 的項目。
例: genre MISSING
<field> PRESENT
返回存在原資料欄位 <field> 的項目。
例: genre PRESENT

時間運算式

<time1> BEFORE <time2>
返回時間 <time1> 在 <time2> 之前的項目。
例: %last_modified% BEFORE 2008
<time1> AFTER <time2>
返回時間 <time1> 在 <time2> 之後的項目。
例: %last_modified% AFTER 2008
<time1> SINCE <time2>
返回時間 <time1> 不在 <time2> 之前的項目。
例: %last_modified% SINCE 2007
<time1> DURING <time2>
返回時間 <time1> 在 <time2> 之內的項目。
例: %last_modified% DURING 2007
<time> DURING LAST <number> <time-unit>
返回時間 <time> 屬於最近指定時間段的項目。
<time-unit>為 SECONDS, MINUTES, HOURS, DAYS, WEEKS 之一，分別代表秒、分、時、日、周。
例: %last_modified% DURING LAST 2 WEEKS
若 <number> 為 1，運算式可以簡化為: <time> DURING LAST SECOND/MINUTE/HOUR/DAY/WEEK

用於這些運算式的時間的格式必須為以下格式之一: YYYY, YYYY-MM, YYYY-MM-DD, YYYY-MM-DD hh, YYYY-MM-DD hh:mm, YYYY-MM-DD hh:mm:ss，其中"Y"、"M"、"D"、"h"、"m"、"s"分別代表"年"、"月"、表"日"、"時"、"分"、"秒"，而其中的個數表示了它們所占的位數。

組合查詢

<expression1> AND <expression2>
返回兩個運算式返回值都為真的項目。
例: artist IS blah AND title HAS blah
你可以將運算式使用圓括號括起來以提升運算的優先順序。( (artist IS blah) AND (title HAS blah) ) OR (%rating% GREATER 3)

<expression1> OR <expression2>
返回兩個運算式中返回值至少有一個為真的項目。

NOT <expression>
返回運算式為假的項目。
例: NOT %last_played% AFTER %first_played%

查詢結果排序

你可以在查詢運算式結尾放入 SORT BY 運算符對查詢結果使用標題格式化運算式進行排序。

SORT BY <sort-pattern>
對查詢結果進行升冪排序。

SORT REVERSE BY <sort-pattern>
對查詢結果進行降冪排序。

注意事項

若運算式使用了 HAS 或 IS 中的 <field> 和 <string> 欄位中含有空格，需要用半角雙引號(")括起來。
例: title HAS "blah blah"

若在 HAS, IS, GREATER, LESS, EQUAL 中的 <field> 含有 #$% 中的任一字元，將會被處理為標題格式化運算式。
例: %codec% IS MP3

若在含有龐大媒體櫃收藏中使用標題格式化運算式而不是使用簡單的欄位名將會大幅降低查詢速度，並且在使用 IS 運算符時將會忽略欄位多值的情況。

若在 HAS, IS, GREATER, LESS, EQUAL 中的 <field> 不含 #$% 中的任一字元，將會視為原資料欄位對待。
例: artist IS Radiohead

不應訪問技術訊息欄位（比如編碼格式的規格）或插件動態提供的欄位。

所有查詢運算式忽略大小寫。所有關鍵字必須為大寫。

運算符摘要

運算符語法注解

AFTER <time1> AFTER <time2>

AND <expression1> AND <expression2>

BEFORE <time1> BEFORE <time2>

DURING <time1> DURING <time2>

DURING LAST <time> DURING LAST <number> SECONDS/MINUTES/HOURS/DAYS/WEEKS
<time> DURING LAST SECOND/MINUTE/HOUR/DAY/WEEK

EQUAL <field> EQUAL <number>

GREATER <field> GREATER <number>

HAS <field> HAS <string>
* HAS <string>

IS <field> IS <string>

LESS <field> LESS <number>

MISSING <field> MISSING

NOT NOT <expression>

OR <expression1> OR <expression2>

PRESENT <field> PRESENT

SINCE <time1> SINCE <time2>

SORT BY SORT BY <sort-pattern>
SORT DESCENDING BY <sort-pattern> 必須處於查詢運算式結尾。

運算符	語法	注解
AFTER	<time1> AFTER <time2>
AND	<expression1> AND <expression2>
BEFORE	<time1> BEFORE <time2>
DURING	<time1> DURING <time2>
DURING LAST	<time> DURING LAST <number> SECONDS/MINUTES/HOURS/DAYS/WEEKS <time> DURING LAST SECOND/MINUTE/HOUR/DAY/WEEK
EQUAL	<field> EQUAL <number>
GREATER	<field> GREATER <number>
HAS	<field> HAS <string> * HAS <string>
IS	<field> IS <string>
LESS	<field> LESS <number>
MISSING	<field> MISSING
NOT	NOT <expression>
OR	<expression1> OR <expression2>
PRESENT	<field> PRESENT
SINCE	<time1> SINCE <time2>
SORT BY	SORT BY <sort-pattern> SORT DESCENDING BY <sort-pattern>	必須處於查詢運算式結尾。